Skip to content

Season 2a server operations (part A) - #13

Merged
pietechsolution merged 13 commits into
mainfrom
season-2a-server
Nov 11, 2026
Merged

pietechsolution merged 13 commits into
mainfrom
season-2a-server

Conversation

@pietechsolution

Copy link
Copy Markdown
Contributor

Draft for CI only. Do not merge: the season 2a SDK changes merge and release together at the end of 2a, on the owner's yes. No version bump, no tag.

What was added (71 operations, method names are the operationIds):

  • seasons: 32 new methods (48 → 80), with typed results. Performances, package prices, publishSeason, checkout tests, import from a previous season, occurrence inventory returns and reclaims, the holder list, season order refund/cancel/date cancel/resend, hosted renewal links, contacts and notices, sales and seat reports, holder and order CSV exports.
  • holders (new resource, 11): customers, holders, holder tickets, ticket transfers.
  • orders (new resource, 9): /v1/orders… and the event order routes /v1/events/{eventKey}/orders….
  • events: 14 event sales methods (buyer checkout, payment gateway, sales readiness/preflight/transition, booking fee, discount codes), added to the existing Events resource because it already groups /v1/events/{eventKey}/… routes.
  • eventSeries (new resource, 5).
  • Transport: mutationWithHeaderReplay accepts PUT (for replaceSeasonPackagePrices), and an internal getText read returns CSV bodies unparsed.
  • 22 new header-replay mutations send one Idempotency-Key reused on retry (36 in all); domain-exact, unsupported, and one-time-secret calls send no key and are single-attempt. CSV exports resolve with text; deleteSeasonPlan and deleteEventDiscountCode resolve with nothing.
  • 10 webhook names added to WebhookEventName.
  • README counts and API table updated; CHANGELOG Unreleased entry.

Local checks:

  • pnpm install --frozen-lockfile and pnpm validate (typecheck, 98 tests, build, publint, attw): all pass.
  • Table-driven tests assert verb, escaped path, query, JSON body, and Idempotency-Key presence/absence for all 71, plus retry behaviour, CSV text, 204 void, and an 80-method count for seasons.
  • seatmap's route reader (coverage.mjs): node: 71/71 sent.

… settings, all 56 webhook names, events seriesKey
…tle (2.16c)

createEventSeries takes fromEventKey: an event already set up becomes the first date under its own key and every other date is a copy of it; name and chartKey are then left out. Every date of a series carries the series' plain name. Matches seatmap slice 2.16c.
Adds releaseSeasonLapsedOffers (POST /v1/seasons/{key}/renewal-offers/release-lapsed, no body, header replay, 202 with the job). retrieveSeasonHostedRenewals pages with cursor and limit (1-500) and answers nextCursor, and listSeasonRenewalOffers pages the same way (1-100). createSeasonRenewalOffers answers 201 {offers} for 100 contracts or fewer and 202 {job, batchId} above that. The bring-across (createSeasonHolderImportFromSeason) answers 202 with a holder_import job above 100 holders. Renewal emails take up to 20,000 offer ids; above that, 422 too_many_offer_ids.
…e_abandoned (p2b)

The public API changes in p2b (b88ed794e..ee7df2921): SeasonBulkJobKind adds date_cancel_void and seasonDateCancelVoidJobId names that job; seasonHolderImportRowsPerCall sizes an import call by its dates (a call over it answers 422 invalid_rows with maxRows); SeasonSingleTicketDates.jobRefused; createEventSeries documents 409 create_abandoned.
…b audit)

updateEventSeries sends only the prices that change: each date keeps its
own price for every category or tier left out. A season's null transfer
or return cut-off means the club default from Settings > Ticket site, or
until the date starts when the club has none. Holder transfers and
returns through the secret key are not stopped by the club's customer
switches; cut-offs still apply.
…part C)

A date its season cancelled never opens again: moving its sales to
testable or live, or reopening it, answers 409 season_date_cancelled,
and an event series "sales on" leaves it closed as a failed item of the
job (season_date_cancelled; not in failedDates). A cancelled date can't
be moved, postponed, replaced or marked as taken place: 409
performance_cancelled.
@pietechsolution
pietechsolution marked this pull request as ready for review November 11, 2026 10:14
@pietechsolution
pietechsolution merged commit 12b7b52 into main Nov 11, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant